home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / tutor / vispas.arj / MANUAL.1 < prev    next >
Text File  |  1985-08-08  |  27KB  |  926 lines

  1.  
  2.  
  3.                           THE VISIBLE-PASCAL MANUAL
  4.  
  5.                      (C) Copyright 1984, William Hapgood
  6.                              all rights reserved
  7.  
  8.                        William Hapgood Associates
  9.                          10 Sycamore Road
  10.                          Wayland, MA 01778
  11.  
  12.  
  13.  
  14.  
  15.                              PREFACE
  16.  
  17.  
  18.  
  19.      VISIBLE-PASCAL is user-supported software.  While it is
  20.      copyrighted by the author, you are authorized and encouraged
  21.      to copy and distribute the disk with the Visible-Pascal
  22.      program files on it, provided that you do not distribute any
  23.      files that have been modified, and that you distribute all
  24.      the files on the disk.  If you find it useful, you are
  25.      encouraged to send a contribution ($35 suggested) to the
  26.      author.  If you include your name and address, you will
  27.      receive a future update.  Comments on features you would
  28.      like to see in Visible-Pascal or reports on program bugs or
  29.      other problems are always welcome, too.
  30.  
  31.  
  32.  
  33.  
  34.                              REQUIRED EQUIPMENT
  35.  
  36.  
  37.      You can run VISIBLE-PASCAL on IBM-PC (or compatible)
  38.      computers, including the IBM-PCjr, with 128K of memory, at
  39.      least 1 disk drive, and DOS 2.0 or higher.  If you write
  40.      programs that use graphics, then a graphics display adapter
  41.      is required (this is built into the PCjr).
  42.  
  43.      You CAN use, if you want: both mono and graphics adapters; a
  44.      printer; or more than 1 disk drive, including a hard disk or
  45.      RAM disk.
  46.  
  47.      An 80 column display is suggested, but not required.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                      TABLE OF CONTENTS
  74.  
  75.  
  76.  
  77.  
  78.      CHAPTER 1:      INTRODUCTION
  79.  
  80.      CHAPTER 2:      GETTING STARTED
  81.  
  82.      CHAPTER 3:      LET'S RUN A PROGRAM
  83.  
  84.      CHAPTER 4:      SCREEN PLAY
  85.  
  86.      CHAPTER 5:      AN INTRODUCTION TO EDITING
  87.  
  88.      CHAPTER 6:      ADVANCED EDITING
  89.  
  90.      CHAPTER 7:      RUNNING VISIBLE-PASCAL PROGRAMS
  91.  
  92.      CHAPTER 8:      VISIBLE-PASCAL SYNTAX
  93.  
  94.      CHAPTER 9:      TECHNICAL DETAILS AND INSTALLATION
  95.  
  96.      CHAPTER 10:     SUMMARIES OF DEMONSTRATION PROGRAMS
  97.  
  98.      CHAPTER 11:     PRETTY PRINTING
  99.  
  100.      CHAPTER 12:     CUSTOMIZING THE KEYBOARD
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.                      CHAPTER 1: INTRODUCTION
  141.  
  142.  
  143.      Pascal is a programming language that is being used more and
  144.      more today, both in education (for example, the College
  145.      Entrance Examination Board offers an advanced placement test
  146.      based on Pascal) and in industry (many programs you see in
  147.      computer stores were written in Pascal). Pascal is both
  148.      well-structured (which means that the logic of the program
  149.      you want to write can be easily written in Pascal) and
  150.      powerful (which means that large and complex programs can be
  151.      written in it).  It is a good idea to learn Pascal: it is a
  152.      good example of what programming is about; and if you choose
  153.      to become a programmer, it is a language which you can use
  154.      in your career.
  155.  
  156.      VISIBLE-PASCAL is a special version of Pascal, with the
  157.      purpose of giving the first-time Pascal programmer an easy
  158.      time writing and programming his or her first programs.
  159.      There is a lot to keep straight when you first start
  160.      programming, and a professional version of Pascal can be
  161.      very confusing at first.  VISIBLE-PASCAL helps in 3 ways.
  162.  
  163.      First, Visible-Pascal makes writing and changing your
  164.      programs simple by including an editor which is very easy to
  165.      learn how to use.
  166.  
  167.      Second, Visible-Pascal makes running your programs simple by
  168.      giving you single keystroke commands to RUN or EDIT your
  169.      program.
  170.  
  171.      Third, Visible-Pascal makes fixing your programs simple by
  172.      showing you the operation of your program as it runs.  This
  173.      is the reason why VISIBLE is in the name of this system.  It
  174.      is as if you were learning how a car works by watching a
  175.      transparent model of the engine, and could observe the
  176.      valves work and pistons move in front of you and in slow
  177.      motion.
  178.  
  179.  
  180.      Who should use VISIBLE-PASCAL?  YOU should, if one of these
  181.      cases applies to you:
  182.  
  183.      --First, if you want to learn enough about Pascal to find
  184.      out what programming is about, or are curious to see how it
  185.      differs from BASIC, then Visible-Pascal will show you this
  186.      quickly and easily.
  187.  
  188.      --Second, if you want to learn Pascal to write serious
  189.      programs, such as for a career or for the CEEB test,
  190.      Visible-Pascal will both make it easy to start and will show
  191.      you exactly how Pascal statements work.  You may eventually
  192.      move on to a 'production' Pascal to write large or involved
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.      programs; however, you will probably always use the
  200.      Visible-Pascal editor as your favorite tool.
  201.  
  202.      --Third, if you teach programming, Visible-Pascal will allow
  203.      you to demonstrate the internal workings of a Pascal program
  204.      for your students, and answer the question: 'What is the
  205.      program we wrote doing NOW?'
  206.  
  207.  
  208.      One final word before you begin.  Learning to program a
  209.      computer is not easy.  You have to learn many details all at
  210.      once: how to operate the computer, what disks and disk files
  211.      are, how to use the keyboard, the rules of the programming
  212.      language, what to do when something happens that you don't
  213.      expect, and on and on.  Don't get discouraged when you don't
  214.      learn it all in one day: NO ONE DOES!  Try to use several
  215.      different ways to learn about computers and programming:
  216.      practice with programs like Visible-Pascal, read a good book
  217.      about your computer or about Pascal, asks friends to help
  218.      you, or join a computer society.  Be patient; soon you will
  219.      pick up the new information and start to feel more
  220.      comfortable with computing.
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.                      CHAPTER 2: GETTING STARTED
  269.  
  270.  
  271.      The VISIBLE-PASCAL distribution disk contains a number of
  272.      files; some are the Visible-Pascal system itself, some are
  273.      demonstration programs for you to try while you are learning
  274.      how to use the system, and some are required for starting up
  275.      your computer with the necessary parts of DOS (the operating
  276.      system that runs your computer). It is not legal to
  277.      distribute Visible-Pascal disks with any of the DOS programs
  278.      on it (they belong to IBM), so unless someone has added the
  279.      required DOS files to your Visible-Pascal disk for you, you
  280.      will have to do this before starting to use Visible-Pascal.
  281.      This is a difficult step for a beginner, so I will describe
  282.      the operations that need to be done, and either someone who
  283.      knows something about the computer and using DOS will need
  284.      to do these steps for you, or you will have to refer to the
  285.      DOS manuals that came with your computer for help with some
  286.      steps.
  287.  
  288.      1. I recommend that you make a copy of the Visible-Pascal
  289.      disk, and keep the original put away 'just in case'. To make
  290.      a copy, you will need to run the DOS program called
  291.      DISKCOPY.  To do this, after you see   A>  on your screen
  292.  
  293.          a) put your DOS disk (version 2.0 or higher) in drive A;
  294.          b) type DISKCOPY A: B:
  295.          c) follow the instructions for putting disks in your
  296.      disk drives.  The Source diskette is the Visible-Pascal
  297.      disk; the Target diskette is the new disk.  If you need
  298.      help, your DOS manuals will help you do this; the procedure
  299.      differs a little depending whether you have 1 or 2 disk
  300.      drives in your computer.
  301.  
  302.      2. Now you need to put the operating system files onto the
  303.      Visible-Pascal disk that you will be using. To do this,
  304.      after you see  A>  on your screen
  305.  
  306.          a) put your DOS disk in drive A;
  307.          b) if you have 2 disk drives, put your new
  308.              Visible-Pascal disk in drive B;
  309.          c) type SYS B:
  310.          d) type COPY COMMAND.COM B:
  311.          e) type COPY ANSI.SYS B:
  312.  
  313.      If you are told to switch disks in steps c, d, or e (this
  314.      will happen if you have only 1 disk drive), follow the
  315.      instructions.
  316.  
  317.      3. Re-boot the computer by pressing Ctrl-Alt-Del.
  318.  
  319.  
  320.      If you have all the required files on the disk, you should
  321.      see a welcome message and a list of the demonstration files
  322.      that are on the disk.  If you have a problem at this point,
  323.      read chapter 9 on installation.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.                      CHAPTER 3: LET'S RUN A PROGRAM
  335.  
  336.  
  337.      In this chapter I will show you how to start VISIBLE-PASCAL
  338.      and how to RUN and EDIT a simple program, and what happens
  339.      when the program contains an error.  You will run a program
  340.      called SOUNDS that comes with Visible-Pascal.
  341.  
  342.      Start by placing your Visible-Pascal working disk (the one
  343.      you made in chapter 2) in drive A of your computer.  If the
  344.      computer if off, turn it on;  if the computer is already on,
  345.      press Ctrl-Alt-Del to reset it. You should see a welcome
  346.      message, a list of program files that are on the disk,
  347.      instructions on how to print this manual, and a request for
  348.      your command:
  349.  
  350.      Command?
  351.  
  352.      A>
  353.  
  354.      When you see this, Visible-Pascal is ready for you.
  355.  
  356.  
  357.              FIRST TIME THROUGH THE SOUNDS PROGRAM:
  358.              stepping through 1 statement at a time.
  359.  
  360.      Type:
  361.  
  362.              RUN SOUNDS
  363.  
  364.      and then press carriage return <CR>.  Now you will see
  365.      Visible-Pascal get the program SOUNDS ready to run.  First
  366.      it checks for errors; then, if there are no errors it shows
  367.      you a copy of the program with the first line that will
  368.      execute highlighted.  There is a menu of commands at the
  369.      bottom of the screen; we will learn some of them in this
  370.      chapter.
  371.  
  372.      Pascal, like any language, has grammar rules that you have
  373.      to follow to write correct programs. I won't try to teach
  374.      you the Pascal rules in these chapters - there are some good
  375.      books that can help you with this. I will help you see how
  376.      programs execute and how to use Visible-Pascal to learn what
  377.      your programs are doing.
  378.  
  379.      As you look at the program SOUNDS, notice the line that is
  380.      highlighted:
  381.  
  382.              DURATION := 500;
  383.  
  384.      This line is the way Pascal tells the computer to make the
  385.      variable DURATION take on the value (become equal to) 500.
  386.      Notice that on the 4th line of the program the variable
  387.      DURATION is declared to be an integer; when a program
  388.      starts, all integers are given the value 0, and this value
  389.      is shown inside angle brackets to the right of the
  390.      declaration:
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.              DURATION : INTEGER; <<0>>
  399.  
  400.      Visible-Pascal shows you the current values of variables by
  401.      putting the value on the screen like this automatically.
  402.  
  403.      You can run the program one line at a time and see what
  404.      happens at each step. To do this, press <space>, the space
  405.      bar, once.
  406.  
  407.      The highlighting moves to the next line, and you see that
  408.      the value of DURATION has indeed changed from 0 to 500:
  409.  
  410.              DURATION : INTEGER; <<500>>
  411.  
  412.      Press <space> once more and see what happens to the value of
  413.      NOTE.
  414.  
  415.      Now the line that is highlighted is:
  416.  
  417.              TONE(NOTE,DURATION);
  418.  
  419.      This statement uses the TONE command which is part of
  420.      Visible-Pascal; TONE needs two pieces of information to
  421.      work: a NOTE and a DURATION of the note. This statement
  422.      shows the way this is written using Pascal's rules.
  423.  
  424.      Press <space>.  Did you hear the note? If your computer's
  425.      speaker is working, you should!  Continue to press <space>
  426.      through the rest of the program until the line
  427.  
  428.              Program complete.
  429.  
  430.      appears. As you use <space> to step through the program,
  431.      watch the value of NOTE change, and listen to the tone that
  432.      is produced at each TONE statement.
  433.  
  434.  
  435.              SECOND TIME THROUGH THE SOUNDS PROGRAM;
  436.              Watching a program run in slow motion.
  437.  
  438.      Type:
  439.  
  440.              RUN SOUNDS <CR>
  441.  
  442.      again. Again Visible-Pascal gets the program ready to run.
  443.      You know how to step through the program one statement at a
  444.      time with the space bar, so this time try a new command:
  445.      press 'W', which stands for 'Watch the program'.
  446.      Visible-Pascal does the stepping for you, and you can watch
  447.      the program run in slow motion. Notice how the value of NOTE
  448.      in the 3rd line of the program changes.
  449.  
  450.  
  451.              THIRD TIME THROUGH THE SOUNDS PROGRAM;
  452.              Running at full speed.
  453.  
  454.      Type:
  455.  
  456.              RUN SOUNDS <CR>
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.      again.  Now you will try the R for Run command, which runs
  465.      the program at full speed without giving you the special
  466.      Visible-Pascal aids.  Press 'R' and listen to the program
  467.      execute.  You see only a blank screen because Visible-Pascal
  468.      doesn't display a program when you Run it, and the SOUNDS
  469.      program doesn't write anything on your computer screen
  470.      itself. Soon, however, you will see how easy it is to put
  471.      statements in a program that write to the screen.
  472.  
  473.  
  474.              FOURTH TIME THROUGH THE SOUNDS PROGRAM;
  475.              learning to edit by making mistakes!
  476.  
  477.      To learn to write your own programs you must learn how to
  478.      create and modify programs like SOUNDS.  You can start by
  479.      modifying SOUNDS like this:
  480.  
  481.      Type:
  482.  
  483.              EDIT SOUNDS <CR>
  484.  
  485.      Now instead of Visible-Pascal getting SOUNDS ready to run,
  486.      you will use the editor to make changes in the program.  The
  487.      chapters on the editor will explain how to use it fully; for
  488.      now, we will use just a few commands to change the SOUNDS
  489.      program and re-run it.
  490.  
  491.      The editor shows you the SOUNDS program, much as it did when
  492.      running it, except that there are only two lines of menu
  493.      information at the bottom of the screen. The editor uses the
  494.      underline blinking cursor to control where you make editing
  495.      changes; right now, it should be under the 'P' of PROGRAM on
  496.      the first line of the screen. To add characters at this
  497.      location, all you need to do is type, so try typing 'X' and
  498.      a space.  PROGRAM becomes X PROGRAM; since this violates one
  499.      of the rules of Pascal (namely, that all programs begin with
  500.      the word 'program'), your program is no longer correct.
  501.      Let's see what happens when you try to RUN it.
  502.  
  503.      To run a program after editing it, do the following:
  504.  
  505.              1) Press <Esc> and you see a menu of editing
  506.      commands;
  507.              2) Press the <F1> function key to use the filing
  508.      system;
  509.              3) Press 'R' to select Replace and Run.
  510.  
  511.      Visible-Pascal will check the program for errors, as before,
  512.      but this time it finds one and puts you back editing, with
  513.      an error message and a pointer to the place where the error
  514.      was discovered:
  515.  
  516.  
  517.      X PROGRAM SOUNDS;
  518.      ^
  519.      -----Error at or before this line:--------------
  520.  
  521.      'PROGRAM' expected.
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.      Correct the program and RUN it again!
  530.  
  531.  
  532.      Visible-Pascal is pointing to the word 'X' and saying that
  533.      it expected to find the word 'PROGRAM' at this point.  To
  534.      correct this error, delete the character 'X' by pressing the
  535.      <Del> key once.
  536.  
  537.      Now re-run the program by doing the same three steps you did
  538.      before:
  539.  
  540.        <Esc>,  <F1>, and 'R'.
  541.  
  542.        Now the program should run correctly as it did at the
  543.      beginning of the chapter.
  544.  
  545.  
  546.      In this chapter you learned how to RUN a program, and how to
  547.      EDIT one; you learned how to step through a program with
  548.      <space>, how to WATCH a program, and how to RUN one at full
  549.      speed.  You learned how to insert and delete characters with
  550.      the editor, and how to fix an error and re-run the program.
  551.      In the next chapter, we will see some more ways to RUN a
  552.      program, and see how a program can write on the computer's
  553.      screen.
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                      CHAPTER 4: SCREEN PLAY
  599.  
  600.  
  601.  
  602.      When you write programs, you will often want to print things
  603.      on the computer's screen and have the program use things
  604.      that you type at the computer's keyboard.  In this chapter,
  605.      we will use a small program called WORDS to learn how to do
  606.      these operations.  You will also learn more about running
  607.      programs.
  608.  
  609.  
  610.      To get started, let's type:
  611.  
  612.              RUN WORDS <CR>
  613.  
  614.      The program that is displayed on your screen uses several
  615.      statements that write on the screen; it also reads
  616.      information from your keyboard.  To start, type <space>.
  617.      Since the highlighting moved down a line, the line:
  618.  
  619.              WRITELN('this is the WORDS program;');
  620.  
  621.      should have executed.  However, it says to WRITE a LiNe on
  622.      the screen, and you don't see any new line of text on the
  623.      screen, do you?  Well, the reason is this: Visible-Pascal is
  624.      using the screen to show you the program and the variables
  625.      and the command menu; there is no place to put the line that
  626.      the program is supposed to WRITE!  And here is the solution:
  627.      Visible-Pascal uses one 'screen', and the program that is
  628.      running uses another.  You can switch between them whenever
  629.      you like; Visible-Pascal keeps track of the information that
  630.      is on each screen, so that you don't have to.  There are two
  631.      'information screens' in use, and either one of them can
  632.      show on your computer's 'physical screen' as you wish.
  633.  
  634.      To switch from the screen you see now (let's call this the
  635.      command screen) to the one with the results of the program
  636.      that is running (let's call this the program screen), just
  637.      press 'S'.  You should see the line:
  638.  
  639.              this is the WORDS program;
  640.  
  641.      press 'S' again to see the command screen.  Press 'S' some
  642.      more to get used to it; when a program is writing
  643.      information to the screen, watching both the command and
  644.      program screens by switching between them like this is very
  645.      useful.
  646.  
  647.      Switch to the command screen; press <space> again; switch to
  648.      the program screen and see the new line added to it.
  649.  
  650.  
  651.      Step through the program with <space> until the highlighted
  652.      line is:
  653.  
  654.              READLN(COUNT);
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.      Switch to the program screen; it looks like the program is
  663.      asking you to type in a number, doesn't it?  Switch back to
  664.      the command screen and press <space> one more time.  The
  665.      lower menu region is replaced with this:
  666.  
  667.      ------------------------------------------------------
  668.  
  669.      Program is requesting input!
  670.  
  671.      ------->_
  672.  
  673.  
  674.      which is your cue to type in the number that the program
  675.      wants.  You must also press <CR> at the end of typing stuff
  676.      for a READLN statement. Until you type <CR>, you can
  677.      back-space to correct errors; the <CR> sends your number,
  678.      etc. to the program.
  679.  
  680.      Note now that on the command screen, the variable COUNT has
  681.      taken on the value that you typed in.  Switch to the program
  682.      screen; your number is there, too.
  683.  
  684.      Switch to the command screen and step the program along
  685.      through a FOR statement, which is used to do something
  686.      several times.  The program is not 'stuck' on one line; it
  687.      is executing that line the number of times that you typed
  688.      in.  You can switch to the program screen anytime to check
  689.      on what is happening.
  690.  
  691.  
  692.      RUN WORDS again, and this time give the 'W' command to Watch
  693.      the program.  Everything you did above will happen
  694.      automatically.  But you will never get to see the program
  695.      screen if you let the program run automatically until it is
  696.      finished.  One way you can get to see the program screen is
  697.      to press <Ctrl-Break> when the FOR statement is executing.
  698.      This stops the program, and you can switch screens then. You
  699.      will learn another way, later.
  700.  
  701.      Finally, RUN WORDS again, and this time give the 'R' command
  702.      to run the program at full speed.  Now you see only what the
  703.      program was written to do, with no aid from Visible-Pascal.
  704.  
  705.  
  706.      Congratulations!  You are doing quite a lot with Pascal,
  707.      especially if you have not yet read the chapters on editing
  708.      or running programs or on the syntax of Visible-Pascal.  At
  709.      this point you can either continue reading this manual, or
  710.      jump right in, using the built-in menus to guide yourself.
  711.      There are other demonstration programs listed in chapter 10
  712.      you can try; and you can edit any of the programs if you
  713.      wish.  However, note that Visible-Pascal does not contain
  714.      every language feature of full Pascal, so you will need to
  715.      skim the syntax chapter sooner or later.  You will also want
  716.      to read about the extras in Visible-Pascal that are missing
  717.      in standard Pascal, such as color, graphics, and sound!
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                      CHAPTER 5: AN INTRODUCTION TO EDITING.
  732.  
  733.  
  734.      The Visible-Pascal editor makes the job of writing and
  735.      modifying Pascal programs really easy. These instructions
  736.      are in two parts:  this introduction tells you how to begin,
  737.      and ADVANCED EDITING tells about powerful features that make
  738.      editing larger programs a breeze. You should read it after
  739.      you feel comfortable using the basics.
  740.  
  741.  
  742.                              PRELIMINARIES.
  743.  
  744.      These instructions assume that your keyboard is an IBM-PC
  745.      one; for the PCjr, you have to learn some special key
  746.      combinations to use for the function keys, etc.  For all
  747.      computers, we will use the following abbreviations for some
  748.      of the keys:
  749.  
  750.              CR      means press the carriage return key;
  751.              BS      means press the backspace key;
  752.              ESC     means press the escape key;
  753.              DEL     means press the delete key;
  754.              F1      means press function key F1 (or F2..F10);
  755.              CTRL-x  means hold the Ctrl key and press x (like
  756.                      SHIFT);
  757.              ALT-x   means hold the Alt key and press x.
  758.  
  759.  
  760.  
  761.  
  762.                      STARTING and LEAVING the editor.
  763.  
  764.  
  765.      To edit a file that is named (or will be named) 'MYFILE',
  766.      just type
  767.  
  768.              EDIT MYFILE
  769.  
  770.      'MYFILE' can be an old file (already on your disk) or new
  771.      (not yet there). If it is an old file, the editor will
  772.      present you with its first page (screenful), and you can
  773.      begin editing. If it is new, the editor will beep at you and
  774.      give you a blank screen to write on.
  775.  
  776.      To leave the editor when you are done, press function key F1
  777.      to bring the filing system menu to the screen.
  778.  
  779.              (Forgot which key?? Press ESC for some memory jogs!)
  780.  
  781.      Now press 'R' to Replace your disk file with an updated
  782.      copy, leave the editor, and Run your program.
  783.  
  784.  
  785.  
  786.                      ENTERING text.
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.      The first step in writing a program, using any editor, is to
  796.      type in your program. Use CR to start a new line, and BS to
  797.      backspace over typing mistakes as you go. The blinking
  798.      cursor shows where the next letter you type will go; the
  799.      'shadow' cursor shows where the end of the current line is.
  800.  
  801.      --Note that CR starts a new line under the start of the one
  802.      above; this AUTO-INDENTING makes neat program writing easy.
  803.      You can adjust the margin with spaces or BS; following lines
  804.      will line up until you change the margin again.
  805.  
  806.      --Note that the editor also AUTO-CAPITALIZEs for you. On
  807.      each line, all letters are capitalized except between
  808.      comment braces {...} or between quotes '...' or "..." . This
  809.      makes your program statements easily distinguishable from
  810.      comments with no work on your part.
  811.  
  812.  
  813.  
  814.                      MOVING the CURSOR.
  815.  
  816.  
  817.      There are several ways to move the cursor around in your
  818.      file. The left, right, up, and down arrows are all you
  819.      really need, but other keys like PGUP (page up) and PGDN
  820.      (page down) make larger moves and are handy. CTRL-left arrow
  821.      and CTRL-right arrow (or END) move the cursor to the start
  822.      and end of the current line, respectively.
  823.  
  824.      --Note that if you move the cursor or type past the right
  825.      edge of the screen, the editor scrolls right to keep the
  826.      cursor on the screen; lines that are partially off-screen to
  827.      the left are clearly marked. Use CTRL-left arrow to return
  828.      to the 1st column position; the right portion of the line
  829.      (past the edge of the screen) will also be cleared marked.
  830.  
  831.      --If pressing the cursor-arrow keys puts numbers into you
  832.      file, instead of moving the cursor, you much press
  833.      Ctrl-NumLock to activate the cursor control function keys.
  834.  
  835.  
  836.                      DELETING and MOVING text.
  837.  
  838.  
  839.      You can backspace (BS) back over text; or, move the cursor
  840.      to the letter to remove and press DEL. Hold it down for
  841.      longer deletions.
  842.  
  843.      To delete 1 or more entire lines, use the cut and paste keys
  844.      F5, F6, and F7.  F5 marks the line where the cursor is,
  845.      highlighting it. Move the cursor up or down to mark more
  846.      lines.
  847.  
  848.      F5 pressed again finishes marking text and puts a copy of it
  849.      in a special copy buffer; the word 'TEXT' on the status line
  850.      tells you a copy has been stored.
  851.  
  852.      F6 deletes the marked lines.  Now, if you wish, you can move
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.      the cursor elsewhere and press F7 to put a copy back into
  860.      the text. It's hard to make a serious mistake since each
  861.      time you delete lines, you can always copy them back if you
  862.      want!
  863.  
  864.      To delete one line, just press F5-F5-F6.
  865.  
  866.  
  867.      That's all you need for now.  See the EXTRAS chapter for
  868.      commands that make your editing even easier, such as:
  869.  
  870.              1. search for words and change them if you want;
  871.              2. find a line by number;
  872.              3. delete words or part of a line;
  873.              4. switch between files;
  874.              5. move text between files;
  875.              6. print parts of your file;
  876.              7. center your work on the screen.
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.